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T h i s cj o c u m e n t c o v €? r b the ad d i t. i o n a 1 -fe a t u r e s o f O M 3! M 0 N L.. & U 

which are not available in the standard version- Please refer to 
the OMNIMON USER’S GUIDE for descriptions of the standard 
f e a t u r e s » A 1 s o , :l t i s p o s s .i b 1 e t o use 0 M N I M 0 N L i n d e p ende n t I y o f 
OMN I MONU - I f you are d o i n g so , ign or e t h e d esc r i p t i on s of t h e 

commands which onlv exist in OMN I MONU <N and Y) - 

/ 

Instal 1 at i on 


T h e 8 K v e r s i o n of 0 M N I M 0 N c: o m e s i n a s p e c i a 3. 8 K c h i p w h i c h 

h a s a s w i t c: hi a 1 1 a c h e d t o i t « Not e the orientati a n o f t h e (Did 
0 M N I M 0 I'm c h i p (the o n e w i t h t h e o r a n q e la b e 1 ) , caref u 1 1 y u n p 3. u g 1 1 
b y g e n t 1 y p r y i n g w i t hi a s c: r e w d r i v e r ( t:« e c: a ref li 1 n o t t o g o u g e t h e 
etch underneath), and plug in the new chip in the same 
orientation. Do not plug the chip in backwards! The end with the 
pins bent under should butt up against the wire connector- If 
is so m e i n t e r -fere n c e , s h a v e a 3. .i. 1 1 1 e b i t o f t h e p 3. a stic o f f ; 
a sharp knife so that the chip will sit down flush- Now 

t h e s w i t c: h s o m e w h e r e b y d r i 3. 3. ing a n a p p r opriate s i z e h o 1 e » 
t h e s w i t c h s h o u 1 d b e c: o n v e n i e n t t o y our 1 e f t h a n cl , m o u nting 
it just above the ESC key is recommended although this requires 
t h a t y o u 1 e a d t h e w i r e s o u t t h e b a 1 1 o m o f c a r d c a q e - M o u n t i n g the 
switch on the left side of the lid would allow you to remove the 
OS board with the lid, but :i t requires cutting a hole in the RF 
shield. Such is the price for the added power of 8K OMNI! 


there 
w i t: h 
mount 
8:1 nee 


Overview of 8K OMNIMON 


»-i 

* 0000 . 
ban ks , 
1 ower 


A 1 1 


versions of OMNIMON reside in the 4K block of memory at 
I m p 1 e m e n t a t. i o n o f : t h e 8 K 0 M N I M 0 N i s d o n e w :i. t h t wo 4 K 

only one of which can be active at any given time. The 
4 K ( 0 M N I M 0 N L ) c o n t a i n s p r i m a r i. I y d i s k I / 0 c o m m a n d s w h i 1 e 


m o s t o f t. h e d e b u g g i n g c o m m a n d s r e s 1 d e i n t h e u p p er 4 K ( (3 M N 3! M 0 N U ) 
E< a n k s e 1 e c: t i o n i s a c h i e v e d v i a a manua 3. t o g cj 1 e switch. 


It is not necessary to memorize which commands reside in 
each bank because the monitor will tell you to flip the switch if 
you use a command which is not in the currently selected bank- It 
will do so in a strange way, but one which took very little code 
space to implement" all the characters on the screen will turn 
upside down- When this happens, don’t get excited. Just flip the? 
switch and hit RETURN- The command parser will turn the 
characters right side up again (what a relief!), search the other 
bank for the command, and execute it if it is found. What if it 
does not find the command in the? other bank either? That’s right: 
the characters will stand on their heads again. If you happen to 
try a command which is not i n either bank, the characters will 
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remain inverted no matter how many times you -flip the switch and 
hit RETURN- To get out of this infinite loop just hit any key 
other than RETURN (like the space bar) and the command will be 
ab or teed » 


A word of warning: DO NOT FLIP THE SWITCH UNLESS THE 

CHARACTERS ARE INVERTED! Other w i s e y o u rn a y eras h t h e s y s t e m . T h e 
reason for this is that bank switching while the CPU is operating 
out of that bank will not work gracefully unless the code is 
i cl e n t i c a 1 in b o t. h b a n k s . 0 n 1 y w h e n t h e c h aracters are 1 n verted i s 

the CPU operating in a region where the code is identical in both 
banks- Thus, even if you know that the command is in the other 
bank, go ahead a type the command and flip the switch only when 
the characters turn upside down- A little annoying at first:, you 
will soon get used to it, especially when you start to appreciate 
some of the extra facilities that 8K has to offer - 


Choosing which commands were to reside 
t: rade o f f h e t w e e n s e v e r a 1 fa c t o r s : 


in each bank was a 


1 ) 
all / 

3) 


G r o u p i n g t h e c o m m a n d s t o m i n i m i z e h a n k s w i t: c: h i n g . 
Group! n g cer t a i n s c o m m a n d s i n t he s a rr» e b a n k s o t h a t 
s h a r e c o m m o n r e s o u r c e s . 

Making the best use of the available space. 


thev could 


It was found that these requirements were fairly complementary: 
each command seemed to fall naturally into one bank or the other. 
Most of t h e dis k I / 0 c omman d s ( R ? W , L , G , B ) ar e in the 1 ower b an k 
while most of the debugging commands ( C , E , J , N ? X , Y ) are in the 

uppe r t) a n k - 8 o m e o f t h e m o s t c: o m rn o n 1 y u s e d commands ( D , A , 7 , P ) a r e 

p u t i n b o t h b a n k s . 

You will find that the MJ 1 * bank is somewhat secondary to the 
9 L P bank- In fact, OMNIMONL will work well without OMNIMONIJ but 
the reverse is not true. The following features of the monitor 
w i 1 1 wor k onl y i f t. h e ? L ? ban k i s selected: 


1 ) 
2) 

3 ) 

4) 


Entering the monitor with OPTION/RESET or SELECT/RESET 
Ex i t i n o t. h e man i t or wit h ST ART /RETURN 

.j 1 

Making use of the ex tendab i 1 i t y features (fixed entry points) 
Using the resident Ramdisk handlers 


Thus, you should leave the lower bank selected whenever you are 
not in the monitor. 


There are some very powerful features in 8K OMNIMON, 
especially the combination of binary load <G> , user ex tendab i 1 i ty 
<U) and programmabi 1 ity (F,0>- It will be very interesting to 
find out all the interesting applications people will come up 
with. If you come up with something nifty, feel free to send it 
in to CDY for possible inclusion in an OMNIMON User Extensions 
disk. If your submission is accepted you will be given credit for 
your work and you will receive a copy of the disk when it is 
available. Others may receive a copy of the disk by sending 
$15. 00 t o CDY . Ca 1 1 f or avai 1 ah i 1 i t y » 
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Assembler: Y addr instruction 


Th i s 
i s a 1 i ne 

1 a n guage a n d i t w i 1 1 
V o u h a v e e v e r h a cl 
h o w h a n d v t hi i s *f la n c t: i o n 
u pi t h e a p c: o d e s i n a table, 
write a qu i c k y r out i n e t o try 
wanted to see what the key codes 
*2FC whenever you press a key., 
f o 1 low i n g c o m m a n d s : 

>Y 600 LDA $2FC 
CMP #*FF 
BEQ *600 
BT A *610 
RTS 

(just hit RETURN 


a s s e m ble r . •’ Y " 

in a line of assembly 

c: od e i mmed i a t e 1 v - It 

/ 

object co d e y o u w i 1 1 k n o w 
1 1 s a v e s y o la f r o rn h a v i n g t o 1 o o k 
, sometimes it is desirable to 
someth i ng out . For ex amp 3. e , say you 
are that get stored in location 
To do so you could type in the 

(get key code) 

(no key pressed?) 

(store new key code) 

to terminate assembler) 


w i 1 3. n o t t a k e the plac e o t y o u r 
a s s e m b 1 e r , me a n i n g t h a t y o u t y p e 

c o n v e r t. i t t o m a c: h i n e 
to hand patch 6502 
c: a n b e . 

A3, so 




pas 


tr: cr 


N otic e t h a t y o u nee?d t: o t y p e " Y a d ci r p 
o n 1 h e a s s e m b 3. er w i 1 1 p r o m p t y o u t o r 
execute this routine" 

>J 600 

> (START /RETURN) 

(press a key) 

> D 6 1 0 ( t o s e e w h a t 


o n 1 y o nee. F r o m t h at p o i n t 

t h i e n e x t i n s t. r u c: 1 1 o n « 1 o 


t h e k e y code is ) 


Here are the rules o-f the assembler: 


1 ) 


To enter the assembler, type ? Y addr 
is the- 1 starting address in hex and 
6502 assemh 3. y 1 an q la age i. nstruct i on . 


instruction' where 
■” i n str lic t i on i s a 


? addr ? 
1 eqai 



To exit the assembler just type RE! TURN when prompted •for 
n e x t i n s t r la c t i. a n . 


the 


3) I -f you want to make a change to an assembly language 
i n s t. r la c t i o n w h i c hi i s a 3. read y o n t; h e s c r e e n , j la s t m o v e t hi e 
cursor up to that instruction (it must be the line with the 
’ Y n at the beginning) ? make the change, and hit RETURN. This 
is valid whether or not you are currently in the assembler. 

4) When specifying operands, hex numbers are preceded by and 

decimal riLAmbers are not. 

5) Branch instructions (BEQ, BNE, etc.) are handled quite easily. 

The operand can be specified as an absolute address (in hex or 
decimal) and the assembler will calculate the displacement. 

Or, if yoLA prefer, vola can specify a displacement preceded by 
+ or Thus. in the example above, the "BEQ *600 51 could be 

replaced by ? BEQ — 5" with the same result. 
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Binary Load / Directory: G (file spec) (addr) 


The 

quite ama 
•from a single 


ommand 
b i n a.r y 


i s r e a 1 I v 


1 oad 


versa 1 1 1 i t y a n d c o n v e n i e n c e o f t h :i. s 
inq. First of all, it will load any 

i i •> i 

or 

7 h is i. n c 1 la d e s f i 3. e s t hat e v e n 
on top of it. Secondly, 


d o u b 1 e dens i t: y A T A R I D 0 S c: o m p a t i b 3. e d i s k ( 2 


c:< «= 


2 . 0P , M V DOS , OSA+2 . 0 , et c „ > . 

cannot load because they load 

searches the disk directory for the specified file, it prints 
the filenames, file sizes and start sectors in hex. For example, 
put a disk with a binary load file into drive #1. Now type: 


f i 1 e 

. 09, 
DOS 
i t 

out 


>G D: filename 


Pretty nice. Plere are the rules for using * G* 


1 ) The file spec i f i cat i on i 
F or ex amp 1 e , ’DEFILE’, 

e q u i v a 1 e n t t. o ’ D 1 : F I L E ’ . 


similar i n 
’ 1 : F I LE , 


f or mat 
and 


to that 
’ F I LE ’ 


of DOS. 
al 1 are 


If you do not give a file specification, ’ G 7 will search the 
directory and not find a match but in the process will print 
out the entire directory. Thus * G ( RETURN ) ’ will give the 
directory of drive #1 while G2: (RETURN)’ yields the directory 
of drive #2. 



A n o t h e r n .i c e f e a t u r e of ’ G ’ i s t h at it w i 1 1 p r i n t. ou t t h e 1 o a d 
vectors of a binary load file if you hold down the OPTION key 
while the file is being loaded. It will print out each load 
vector and pause before it loads the data to satisfy that load 
vector. Pressing SELECT will load the data and print the next 
load vector. If you wish to terminate the load, press START. 
Try loading several binary load vectors while holding down the 
OPTION key and you will be surprised at how complicated some 
o f t h em are (the ATARI Macro A s semb I er for Instance). 


4) One final option concerns the sector buffer address which ’G’ 


uses while it 
addr e s s , $ 4- 0 0 

load into this 
f or doub 1 e ) , 
wh l c h does n o t 


is loading the* file. If you do not specify an 
is the default. If the binary file happens to 
area ($400~47F for single density or $400— $4FF 
you may specify another buffer address in hex 
interfere with the load. 


By the way, once the binary load has started, ’G’ uses zero 
page locations $43-49. These are locations reserved for use by 
DOS, in particular during a binary load. Thus, J G ? should load 
anything that the ’ L ’ option of DOS does. However, some files 
may not load correctly if you use the console switches as 
described in rule #3 above because the resources used to print 
out the load vectors may interfere with the load itself. 


Binary Load Files 

This is one area that most people are a little fuzzy on. 
It’s not surprising really, since there does not appear to be any 
definitive documentation on it anywhere! An exhaustive 
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p r esen t. a t i o n 
short. You 
powerful . 

De-f i n 1 1 i on : 


wi 1 1 he made here 
w i 1 1 s e e t h a t b i n a r v 


e v e n t h o u g h i t w i .1 .1 b e 
1 o a d f i 1 e? s a r e s i rnp 1 e b u t 


qu i t e 
ver y 


4 to 6 bytes consisting o*f 2 
FF, a 2 byte start address* and 
( i n that order ) . 


Ex amp 1 e : 


load vector — from 
o p t .i o n a 1 b y t. e s o f F F 
a 2 byte end address 

FF FF 00 06 02 06 — The first. 2 bytes are optional 
and ignored during the load process. The second 2 
bytes are a start address of $600 and the last 2 
bytes are an end address of $602. 


The 

at the 




on 1 y t i me t h at t h e f i rst 
i s at the beginning of a binary load 
there, DOS will refuse to perform 
command of OMIMIMQNL will, however* 
the time the first 2 bytes of FF FF, 
Th e? on 1 y t i me t hat t h ese 2 op t i on a 1 
e 1 s e b u t a t t h e begin n i n g of a f i 1 e 
were a p p e n d e d toge t h e r „ 


bytes of FF FF are required 
file. If those bytes are not 
the binary load. (The ’G" 
load it gladly.) The rest of 
if they exist, are ignored, 
bytes sh on 1 d occ ur an y wh er e 
is if 2 binary 1 oad f i I es 


Wi i at does a I o a d v e c t o r d o 2 It tells DOS (or the (3 c o m m a n d 
of OMNI MON) where in memory to put the 1 or more bytes which 
follow in the file. Flow many bytes is determined by subtracting 
the start address from the end address and adding 1. In the 
example above, 3 bytes would be-? read from the file and put in 
3. o c a t i o n s $ 6 0 0 t o $ 6 0 2 . 


What happens when enough bytes have been read in to satisfy 
a load vector? These things will happen in this order: 

1) Locations $2E2 and $2E3 will be examined. If they are both 
zero, goto step 2. If they are nonzero, a JSR will be made to 
the address contained in these locations. Upon return, zero 
$2E2 and $2E3 and fall into step 2. 

2) If the end of file is not reached ( i . e . , there are more bytes 
i n the f i I e ) , another 1 oad vector i s assumed to i mmed i at el v 
follow and will be processed as previously described. 

3) If the end of file (EOF) is reached. examine locations $2E0 
and $2E1. If they are zero, terminate the binary load. If they 
are nonzero, do a JSR to the address in these locations. 
Upon return, terminate the load. 

Still confused? Let me try to simplify. If you see a 1 oad 
vector like ’ E2 02 E3 02 ? , you know that the subroutine at the 
address specified in the following 2 bytes will get executed 
immediately* prior to continuing the load process. If you see a 
load vector like *" E0 02 El 02 ’ , you know that the subroutine at 

n the following 2 bytes will be executed after the 
;• reached. 

that this helps you understand this topic a little 
ich as I enjoy talking to people on the phone, I get 
a little ti red of ex plaining how a b .i nary 1 oad file wor ks ! 


the 

addr ess 

end 

of 

file i 


I 

hope 

bet 

ter . 

As rr 


page? c* 
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Fill Program Buffer: F addr 


I f y o u f :i n cl y o u r s e If u b i n g a cer t a i n sequence o f 0 M N I M Q N 

commands f r e q u e n 1 1 y ? y o u m a y w a n t t. o p r o g r a m t h e m on i t o r t o 

e x e c u te t h e m a u t. o m a t i c a I 1 y „ Li kewi s e - i f y ou are de b u q q i n q o r 

anal yz i n g a p r o g r a m - v o u m a y w a n t t h e m o n 1 1 o r to re m e m b e r t; h e 

sequence of commands so that you can duplicate them at a later 
t i m e * T h e *" F a d d r ’ c o m m a n d tel 1 s □ li N I MON to star t s a v i n g 
commands at the specified address (the program buffer) . 
continue to save your commands until you execute an ’Fid' 
it to quit,, Then the " 0 addr*" command is used to execute 
program buffer at any later ti me- 


al 1 your 
It will 
t. o t e 1 1 
from the 


The -format of the 9 F 9 command is as follows: 

F addr — "addr" can be any non-ZF'AGE address in RAM- It will 

enter the program mode at this point, remembering 
all subsequent commands- An addr of 0 terminates 
the program mode. 


T h e pro g r a m b uf fe r s h o u 1 d b e a p 1 a c e i n mem or v 
1 n t erf ere w i t h a n y t. h i n g els e y o u are? d o i n g - A s 1 o n g 
the program mode the ASCII data stored in the 
continue to grow, eventually wiping out everything 
y o u for g e t. t. o t e r m .i n ate the progra m m o d e w i t. h " F 0 " . 


that wi 1 1 not 
as you are? in 
buffer will 
in its path if 


Since the data stored in the program buffer is 
you may edit it if you wish. Just remember that the 
must be terminated with a hex 0. Also, if you wish 
program mode and append to the end of the current 
start over, you may do so as follows: 


ASCII text, 
program data 
to enter the 
data rather 


>7 

>S addr F'0 

A x x x x F0 

>F xxxx 


(to q e t i r 1 1 o c h a r a c: t. e r m o d e ) 

( addr =pr ogr am buffer; find *"F0") 

(which previously exited program mode) 

( star t f i 1 1 i n g b u f f er at t hat 1 oc a t. i on ) 


One slight annoyance you will encounter in the program mode 
is that the result of the "7*" command depends on the the current 
mode (char or hex)- If you use the " 7 " command as part of the 
programmed sequence you will want to force one mode or the other 
at the beginning of the sequence so that you will always get the 
same results no matter what mode you happen to be in when you 
execute the sequence later. It is possible to force the hex mode 
with the following sequence :*" A98 0" . 

If the data of your command buffer is of any importance you 
may want to back it up occasionally to a scratch disk. This could 
be done as follows: 

1) Find the ? F0" at the end of the buffer as in the example 
above and add 3 to determine the end address. 

2) Subtract the start address from the end address and divide by 
the sector size to determine the number of sectors to write?- 

3) Write that number of sectors off to a scratch disk with the 
’W* command- Be sure to include the buffer terminator, hex 0. 
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R e? s t o r i. n q a p r e v i o u sly b. a v e ci b uf-f e r is a s e a sy as r eadi n g 
the sectors back into memory with the R 3 command. If the command 
sequence is of lasting importance, you may want to create a 
b .i n a r y I o a cl f i 1 e b y q o i ng to D (D S a n d d o i n g a B I N A R Y S A V E o n t. h e 
comm a n d b u f f e r » T h e G 3 comma n d m a y t h en be u s e cl t o f e t c h i t a t 
any time. Now. say the command buffer starts at $600. Getting 
to automatically execute when it is loaded can be accomplished 
appending the following 2 load vectors: 9E 00 9F 00 00 06 21 

22 03 A1 CF„ These load vectors simulate the 3 □ 600 3 command 
storing the start address at COMP TR and installing the special 
handler (to be described in the next section). In fact, this i <• 
general technique which can be? applied to any program which uses 
the screen editor (E: ) for its input. A simple example would be 
to create an auto-execute command file as described above 


i t. 
b v 

j 

id 3 

by 

E: 

a 


consisting of DO: 


o 

m l mmt ft 


0S commands instead of OMNIMON commands. Then 


use the 'L' option of DOS 2.0S to 1 oad that file. It should 
automatically execute the commands you stored in the file. 


w a v 


How do you go about appending these load vectors? One easy 
to add a few bytes to the end of a file is as follows: 


1 ) 



Find the last sector of a file by putting OMNIMON into the 
linked mode, determining the start sector, reading it into 
memory with the R •" command and holding down RETURN until 
* EOF 3 i s pr i nted out « 

Determine the last data byte of the sector by looking at the 
byte count (the last byte of the sector). In the case? of a 
command buffer this should be a hex 0. 

Just past the last data byte add the new bytes. Then increase 
the byte count to reflect the appended bytes and write the 
s e? c tor" b a c k o u t w i. t h 3 W (ret u rn) 7 . 


Operate from program buffer: O addr 


T h is co m m a n c J i s 
ASCII t; ex t s ome wh er e 
f o r m a t i s a s f o 1 1 o w s : 


used to execute OMNIMON commands stored 
in memory (and terminated with a hex 0) „ 


as 

The 


0 addr 


addr 


stored 


is the address of 
as ASCII text. 


the 0 M N I M 0 N c o m m a n d s 


Upon execution of the 11 O 3 command, the display editor (E:) 
device vector at location $321 is replaced with a pointer into a 
special handler in OMNIMON which takes its input from the program 
buffer (which is pointed to by $98, COMF'TR) instead of the 
keyboard. It will continue to do so until the command interpreter 
hits a hex 0 in the program buffer, at which point input it will 
r ever t back to t h e k ey boar d . 

One thing you will notice when using the 'O' command is that 
only the results of the commands are printed, not the commands 
themselves. If you need to see the commands also, turn on the 
printer with 3 F‘ 3 prior to executing 3 0 3 . The commands will show 
u p o n t. h e hardc o p y . 
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Move Memory: M addr0 addrl addr 2 


T h i s c o m m and i b f o r m o v 3. n g b 1 o c k s of code- f r o n* a n y w h ere i n 
memory to anywhere in RAM » It matters not if the source and 
destinatio n b 1 o c k s o v er 1 ap . 7 h e m o ve c o m rn a n d i s v e r y s i m p I e t o 
u © e „ J u © t s u p p I v t h e f o I low! n g a dd r esses : 

addr0 = source start address 
addrl = source end address 
addr2 = destination start address 

For example, say you have the -following code located at $6 00 (you 
can use the ' Y ' command to enter it): 


$ £>0 0 
*603 
*605 
*607 
*60 A 
*60D 
* 6 0 b 


LDA *2FC 
CMP #*FF 
BEQ *600 
STA *60D 
JMF *60E 
MOP 
RTS 


but 1 wish to 
600 60 E 620. 


make a point. 
Now use ' X ' 


To 
to 

you will recognize it as the 
r e 1 oc at ab 1 e , you won 1 d not b e 


I know this is a dumb program 
move the code to *620, type: M 

disassemble the code at *620 and 
same. Now, unless the code were 
able? to run the code at the new location without adjusting some 
of the absolute addresses. Which addresses? The ones which 
reference locations within the address space of the program. The 
* ST A *60D ? and '’JMF* *60E' would both have to be adjusted. That is 
the purpose of the Relocate command ( ? N ? ) , to be described next. 


Relocate 6502 Code: N addr0 addrl addr2 (addr3) <addr4) 

Relocate will adjust code assembled to run in one location 
so that it will execute in another . The format is as follows: 

addr0 = start of addr reference range to be adjusted 
addrl = end of addr reference range to be adjusted 
addr2 = new base addr 

addr3 = start addr of code to be adjusted (default: addr2) 
addr 4 = end addr of code to be adjusted 

(def aul t : addr 3+ C addr 1— addr 03 ) 

This command was designed to be very flexible but, because 
it. has so many options, it can be quite contusing. However, since 
it was also designed to complement the 51 M' command, its use 
usually requires no thinking at all. Specifically, in the example 
above we used ' M 600 60E 620' to move the code? from *600— 60E to 
*620. Because it has absolute memory references to the range of 
*600— 60E, the copry at *620 will not execute properly. If we now 
move the cursor back up to the ' M' command and change the * M ' to 
an ' N' C'N 600 60E 620') and hit RETURN, the code at *620 will be 
adjusted to run at *620. Try it and then disassemble the code at 
*620. Notice the absolute memory references to the range of *600— 
60E have been ad -justed to reflect the new base address of *620. 
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N o w , sa y w e w a n t e d t o a d j la s t 
w i 1 1 r u n a t $ 7 0 0 b u t w e don't 
(perhaps you did not want to wipe 
I n t h i s c a s e w e m u s t s p e c: :i. f y a d d r' 


the code at $600— 6 0E so that it 
w a n t. t o m o v e t h e r e t o cl o i t 
o u t D 0 S , w h :i c h s t. a r t s at $ 7 0 0 } . 
3 a n d ad d r 4 a s f o 1 1 o w 55 : 


N 600 60E 700 600 60E 


N o t i c: e t h a t a d d r 0 , J. & 2 a r e t h e 
to $700 -first ( ? I1 600 60 E 700 ? ) 
t h e c od e p h y s i cal 1 y r es i d es at 
above command the code at $600— 


same as i -f you had moved the 
but that ad dr 3 & 4 tell 9 N 9 
$600--60E - A-f ter ex ectAt: 3. on o-f 
60E cl i sassemb 1 es to t. h .i s : 


c: ode 
t h a. t 
t h e 


$600 LDA $2FC 
$603 CMP #$FF 
$605 BED $600 
$607 STA $700 
$60 A JMF $70E 
$60 D NGF 
$ 6 0 E. RIB 


Notice that the reference to $2FC is not modified because it is 
outside the address range specified by addr0, 1. Also,, don't worry 
a b o u t *■* B E Q $ 6 0 0 9 b e c: a la e> e .i t i s r elocat a b 1 e . 


Before you try relocating a big program like a cartridge, 
let me point out that it will probably still take considerable 
work. The 9 N 9 command cannot differentiate between 6502 
instructions and imbedded program data. The only thing it can do 
is stop if it hits an illegal opcode and this may or may not be 
soon enough to avoid modifying some data it should not have (data 
that happened to look like 6502 code with absolute address 
references) , It also cannot do anything about indirect references 
to the address range of addr0, 1 (for example, indirect references 
to a data table imbedded within the program) . Likewise, jump 
tables will not be adjLAsted. The data tables should be easy to 


locate and move with the 'M' command, 
w 3. 1 1 p r ol::« a b 3. y b e more d 3. f f i c la 1 1 t o f i n d 
tables will have to be adjusted by hand, 
most easilv used to move relatively small 

/ 1 


The indi r ec t r ef eren c es 
a n d ad j u s t „ T hi e j u m p 

T h li s , the ' N ? c o rr * m a n cl i s 
r out i n es aroun d . 


Although big programs may present a problem, I will give one 
other example to show how versatile the Relocate command really 
is. Say you wanted to move a routine from one part of a program 
to another. Not only would you have to relocate the routine but 
you would also have to use the ’N*’ command on the rest of the 
program to adjust any references to that routine. Say you had the 
following program: $600 LDA $604, X (start of routine) 

$603 RTS 


$604—607 (imbedded data table) 

$608 LDX #3 (this is start of program) 

$60 A J SR $600 

$60D STA $D00 1 , X 

$610 DEX 

$611 BNE $60 A 

$613 RTS 
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You would like? to 
$ 6 0 0 t. o $ol4 „ 1 hi 0 


m o v e? t. hi e? r o u t i n e and associate d 
f o 1 1 o w :i n g c o m m a n d s w i 1 1 d o t. h i s : 


d a t a 


table -from 


After 


t h 0 S 0 


>M 600 607 
>N 600 607 


c o mm a n d s t h e 


614 (mo v 0 3. i 1 1 3. e r o u t i n e a n d t a b 3. e ) 

6 1 4 608 617 (relocate enti r e p r og r am ) 

p r ogra m s h o u 1 d 3. o o k 3. i k e t h i s : 


$608 

LDX 

#3 

$ 6 0 A 

J SR 

$614 

$60D 

ST A 

$0001 , 

$6 1 0 

DEX 


$6 1 1 

BNE 

$60 A 

$613 

RTS 


$6 14 

LDA 

$618, X 

$617 

RTS 


$6 1 8- 

-6 IB 



(this is start of program) 
X 


(start o-f routine) 
(imbedded data table) 


St ud y this ex amp 1 e car ef u 1 1 y 1 f you un d er stand it 

then you have mastered the *|\T command. You will find 
with ’ Y ’ , ’M’ and * X ’ ) a big help in patching programs 

you don’t have source code or don't want to take the 
rea ssemb 1 e * 


c omp 1 et e 1 y 
it (along 
for which 
time to 


Hexadecimal Arithmetic: H # (# oper) (# oper) ... 


This is an enhanced version of the original ’ H ’ command for 
converting hex to decimal and vice versa. It allows you to 
specify an additional hex number followed by an operand. The 


operands are •+• (add) * 
For example: 


(subtract) , * ( mu ltiply), and / (divide). 

>H C000 A 000 - 80 


/ 


$ C 00 0=49152 
$ 2 000 = 20 4 8 
$0040=64 
>UJi A 000 40 


This example calculates the number of 
r e q u i r e d t o w r i t e a n 8 K bloc k of me m o r y 
converted to decimal, then $A000 is subt 
is printed out, and finally the result 
quot i en t is p r i n t ed out . 


single density sectors 
to disk. $0000 is first 
r acted and thee difference 
is divided by $8)0 and the 


The rules of the Hexadecimal Arithmetic command are: 

1) The first number may be in hex or decimal with a decimal 

number terminated by a non— hex character (i.e., 256T=$100) . 

2) Every number after the first must be in hex. If you need to 

use a decimal number, convert it to hex first. 

3) The divide operand (/) rounds down for fractions less than .5 

and up for fractions greater than .5. 
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Verify Memory: V addr0 addrl addr2 

C o m p a r e 2 b 1 o c k s of me rn o r y a n c:! p r i n t o u t t. h e d i f -fere n c: e s „ 
The first block starts with addr0 and ends with addrl „ The second 
block starts with ad dr 2. 

P Command Enhancement 

The trace turned on by the P command can now be redirected 
to any output device. If it is desired to output to something 
other than the printer ? store the device spec i f i cat i on someplace 
in memory and point $125 (PETJFAD) to that location. The P command 
will then open up an I/O channel to that device and the next P 
command will cl ose i. t „ 

For example, if you were to store ? D:TEMF’ ? (notice the 
blank used as a terminator) at $600 and store 00 06 at $125, the 
P command would open up a disk file (assuming of course that an 
FMS is in memory). This particular example may cause you some 
problems if you have a Ramdisk in the system and you are using 
t h e 8 K h a n ked s w i t c: h v e r s i. o n o f 0 li N I li 0 N . S i n c e t h e? R a m d i s k 
handlers exist only in the lower 4K ( L ) , you would not be able to 
switch to the upper 4K <U) unless the I/O channel we? re to a real 
disk drive whose drive # is greater than that of the Ramdisk. 

Sector I/O Enhancements 

The buffer default of $6000 no longer exists so you must 
specify the buffer address on the first sector I/O (R or W) . 
Also, on multiple sector reads you can now get the sector map by 
holding down the OPTION switch during the operation. 


If a Happy drive is read or written to with a sector 
$800 or greater, the Happy drive treats the sector # 
internal b u f fer address ( $800—$ 1 3F F ) . On mu 1 1 i p 1 e read s or 
the sector # is incremented by $80 each sector. Usage of 


as 


# of 
an 
wr i t es 
the RAM 


buff er is as foil ows ( c: omp 1 i men t s of David Mi 1 1 i g an of 

Surrealistic Software) 

$800 --$A7F - RAM area for program uploading, as in programming the 

d r i ve t o d o some t h i n g . 

RAM area used by the onboard O.S. as a scratchpad 
area. Used for pointers, flags, etc:. 

-RAM area for track reads and writes. 


$A80~$AFF 

$B00-$13FF 


New Ways to Exit OMNI MON 


•i 

1 T 


The •’ J (addr)" command works as it always has except that 
you omit the address it will exit OMNI MON just like START/RETURN. 
This is to make it convenient to execute a subroutine from the 
upper 4K (U) . The formal way to exit OMNIMON is still 

START/RETLJRN and must be executed from the lower 4K. 


The ’Z* 
OMNIMON via 
registers are 


coniman d e x i t s 0 M N I M 0 N wit h a n R T S . 
J SR NXTCMD <$CF6C) , this is how to 
not valid if you enter this way. 


If you enter 
exit.' The CPU 


8K 
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OMNIMON User Extensions 


Advanced users of OMNIMON may desire to add their own 
c o m friands t o t h e moni to r . The n L " v e r s i o n o f 0 M N I M ON a 1 1 o w s y o u t o 

d o j u s t t h a t. h y p r o v i d i n g *f i x e d e n t r y p o 1 nts i n t o 1 1") e m o n i t a r for 

access to the common I/O routines and a 7 LJ command tor executing 
a user- wr i 1 1 e n e x t e n s i o n t o t h e m o n i t o r - T h e e x t e n s i o n c ould he 

permanently installed into the OS in place ot the cassette 
handlers (assuming you have an EPROM burner) or any one of 

could be loaded in from disk with the 7 G 7 (binary load) 
It the location in memory ot the extension happens to 

with the work you are doing at the time, you can move it 

7 M 7 command and, it necessary, relocate it with the 'N 7 
(which resides in the 7 U 7 version ot OMNIMON). You can 
see that the user ex tendabi 1 i ty feature ot OMNIMONL is indeed 
very powerful in the hands of an expert! 


several 
command . 
c on f 3. i c t 
w i t h t h e 
command 


The first order of business is to explain what resources are 
available to you as an OMNIMON programmer. The following is a 
list of the memory locations which are used by OMNIMON: 


TIBPTR 

T I BNUM 

PARM0 

FLAGS 

LAST 

XSAVE 

Y S A V El 

TEMP 

COMP TR 

SSFLAG 

PC SAVE 

DRVNUM 

L I NK 

PBIJFAD 

USRVEC 

TIB 



EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 


EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 


$92 

$94 

$96 

$98 

$99 

$9A 

$9B 

$9C 


5 POINTER INTO TERMINAL INPUT BUFFER (TIB) 

5 LAST # CONVERTED FROM TIB, GEN PURPOSE REG 
52 BYTE GENERAL PURPOSE REGISTER 
5 INTERNAL FLAGS 

5 LAST PERSISTANT COMMAND EXECUTED 
5 USED TO SAVE X REGISTER 
5 USED TO SAVE Y REGISTER 
52 BYTE GENERAL PUPOSE REGISTER 


$9E 52 BYTE POINTER INTO PROGRAM BUFFER 
$120 5 SINGLE STEP FLAGS 

$121 5 USED TO SAVE PC DURING SINGLE STEP 

$123 5 CURRENT DRIVE # SELECTED 

$124 5 LINKED OR SEQUENTIAL MODE FLAG 

$125 5 POINTER TO DEVICE SPEC WHEN USING 7 P 7 CMND 

$127 5 POINTER TO USER EXTENSION ROUTINE 

$129 5 TERMINAL INPUT BUFFER 


These are:- the locations used by the L and H versions,, Every 
attempt will be made to keep these variables fixed from now on. 
These may or may not be correct for earlier versions of OMNIMON. 
To be sure, scan the OMNIMON code starting at $C000 and it should 
be easy to determine which part of the zero page and the stack 
are used for these variables. It is advisable to use the same 
labels (TIBPTR, T I BNUM, etc.) in your programming. 


By the way, the zero page locations used by OMNIMON are 
preserved on the stack upon entry to the monitor and restored on 
exit. Thus, a routine you are debugging with OMNIMON may use 
these zero page locations, even when using the 7 J 7 or 7 E 7 command 
to execute them from OMNIMON. (Did you know that both J and E 
leave OMNIMON while executing your code and return upon 
completion?) However , they will not reflect the correct values if 
you use the 7 D 7 command to look at them because the OMNIMON 
variables are in use at that time. 
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OMNI MON Entry Points 


T h e r e are q u j. t e a n u m b er of r o u t i n g s i n 0 M N I MON w h i c:: h will 
be useful to you as a programmer. Access to these routines is 
p r o v i. cied i n OMN 1 MONL b y a n urnb er of f i x ed en t r y p oints, 11 f i x ed ’ 
m ean i n q t h a t t h e s e ad d r e s s e s a r e g u a. r a n t e e d t o r emai n t. hi e s a m e i n 
f u t u r e r e v i s i o n s of 0 M N I M 0 N L„ „ Some of these r o u tin e s h e 1 p v o u 
process user input., while others allow you to format data output 
and messages to the screen. Still others help you interface to 
the disk drive. Each entry point will be covered in detai 1 , but 
first let’s take a look at what is available and a short example. 

Get. user program counter to PARM0 
Print 8 bytes ©PARM0 in current output format 
I nstal 1 Ramd i sk as dr i ve spec .i f i ed in T I BNUM 
Convert user decimal input to hex in T I BNUM 
Read drive status to determine density 
E e a d a sec t o r f r o m d i s k i n t o m e m o r v 

t 

Write a sector to disk from memory 
Increment sector # and buffer address 
Convert user hex input to hex in T I BNUM 
Pr i n t byte i n acc urnu 1 at or to sc r een i n h ex 
Pr i n t c on ten t. s of CPU r eg i s t er s to the sc r een 
Fetch 3 user arguments 

Move 2 byte contents of T I BNUM to PARM0 
Inc r emen t 2 byte p ointer , T I BF'TR , b y 1 
Print 2 bytes in PARM0 to screen in hex 
Get a line of input from the user ~> TIB 
Increment 2 byte pointer, PARM0, by 1 
Print # blanks to screen as specified in ACC 
C o n v e r t. A S C I' 1 i n accumula t. o r t o h e x 
Fetch 2 user arguments 
P r i n t i n 1 i n e t. e x t t o screen 

Print ASCII character in accumulator to screen 
Force (unprintable) ASCII character to screen 
P a s s c In a r a cter i n accu m u 3. a t o r t o C I G 

Jump Entry Points: 

BOOT $CF66 Boot from the drive specified in DRVNUM 

INPERR $CF69 Return from command which prints ? INPUT ERR’ 

AUTGO $CF1B Execute from command buffer starting ©COMF'TR 

NXTCMD $CF6C Normal return from command 

RESTOR $CF6F Normal exit from OMN I MON (restores zpage vars) 

RESET $CF72 Normal RESET 

RESET2 $CF75 Altered RESET (SELECT/RESET) 

PWRUF'0 %CF 78 F'owerup entry for lockup recovery 

Notice that the entry points of the first set are called with 
’JSR"’ while those of the second set are used with ’JMP’. Once 
again, it is advisable to use the mnemonic: labels provided here 
rather than make up your own. This will make it easier for other 
OMN I MON users to understand your routines. In fact, you are 
invited to submit your OMN I MON ex t en s i on s to CD Y for i n c 1 us i on i n 
an OMN I MON User Ex t en 1 1 one ’ d i s k . 


page 13 


Subroutine Calls: 

F'CTPAR $CF 1 E 
PRTLIN *CF21 
INSNUM $CF24 
DECONV $CF27 
DRVTYP $CF2A 
SECTRD *CF2D 
SECTWR $CF30 
SEC INC *CF33 
TIBCNV $CF36 
PR T HEX $CF39 
PRTCPU $CF3 C 
ARGU3 *CF3F 
NUMTOP ^CF42 
I NCF’TR ^CF45 
PRTADR *CF48 
GETREC *CF4B 
INCPAR $CF4E 
F’RTBLK T>CFbl 
HEX CON «CF54 
SSGET ^CF57 
PRINT $CF5A 
PUTCHR ^CF5D 
PRTCHR *CF60 
CIOCHR $CF63 
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OMNIMON Em tension Example 


A si- h o r t e x a m p 1 e m i. q h t h e 1 p y o u u n d e r s t a n d w h y i t: i s t h a t; y o u 

w o u 1 d w a n t t o w r i t. e a n e x tensi o n t o □ M N I M (3 N . Say y o u a r e 
d evelop .i n g a p r ogr a m -for p u b 1 icatio n a ri d y o u are w o r k :i. n q o n a 
p r o t e c t :L on sc he m e * P ar t o f a t y p i c a 1 p r o t e c t :i. o n s c I") e m e :t t t o u s e 
a byte as a mask to EOR (exclusive— or) over a range of memory 

chec k s u m ove r t hi e r a n q e . T o -f a c i 1 i t. a t e 


and then 

t o 

d o a 

de vo lop merit you wish 

an address 

range and 

and check 

sum 

over t 

ex tensi on 

wi 1 I 

d o t h e 

TIBPTR 

EQU 

$92 

T I BNUM 

EQU 

$94 

PARM0 

EQU 

$96 

USRVEC 

EQU 

$127 

TIBCNV 

EQU 

$CF36 

NUMTOP 

EQU 

$CF42 

INCPAR 

EQU 

$CF4E 

PR I NT 

EQU 

$CF5A 

PR THE X 

EQU 

$CF39 

PUT CHR 

EQU 

$CF5D 

NXTCMD 

EQU 

$CF6C 


r ange. The -foil ow i n g OMN I MON 


5 POINTER TO USER EXTENSION 
5 CONVERT A PARM FROM USER LINE TO HEX 
; TRANSFER 2 BYTES OF TIBNUM TO PARM0 
5 INC 2 BYTE POINTER, PARM0, BY 1 
; PR I NT I NL I NE TE XT TO SCREEN 
5 PRINT ACCUMULATOR T'0 SCREEN IN HEX 
5 PRINT CHARACTER IN ACC TO SCREEN 
5 E X I T USER E X TENS I ON 


ORG USRVEC 
DW EORMEM 


THIS LOAD VECTOR WILL INSTALL ROUTINE 


ORG $600 


* EOR MEMORY ( •’ U start-addr end-addr mask-byte’ ) 

* 

EORMEM 

5 FETCH START A DDR FROM USER LINE -> TIBNUM 
;DID USER NOT SUPPLY A START ADDRESS? 


JSR 

BMI 


TIBCNV 

EOREX 


JSR NUMTOP 
JSR TIBCNV 
BMI EOREX 


5 TIBNUM ~ > PARM0 

; FETCH END A DDR FROM USER LINE -> TIBNUM 
5 DID USER NOT SUPPLY AN END ADDRESS? 


LDA TIBNUM 
F'HA 

LDA T I BNUM +- 1 
PH A 

JSR TIBCNV 
BF'L EORMSK 


PUSH END A DDR' ONTO STACK 


5 GET MASK BYTE FROM USER LINE -> TIBNUM 
; DID USER SPECIFY A MASK? 


LDA 

STA 

EORMSK 
LDY 
PL A 
STA 
PLA 
STA 


#$FF 
T I BNUM 

TIBNUM 

TIBNUM+1 

TIBNUM 


5 NO, ASSUME #$FF 
; MASK ~ > Y 

? RESTORE END ADDR TO TIBNUM 
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TV A 
PH A 
LDY 
STY 
EDRUP 
PL A 
PHA 
EOR 
STA 
CLC 
ADC 
STA 
JSR 
SEC 
LDA 
SBC 
LDA 
SBC 
BPL. 


#0 

T 1 BF'TR 


n PUSH MASK ONTO STACK 
5 USE TIBPTR TO ACCUMULATE CHECKSUM 
5 GET MASK 


( PARM0 ) , Y ; MASK BYTE OF MEMORY 
( PARM0 ) , Y ; STORE THE MASKED BYTE 


TIBPTR 
TIBPTR 
INC PAR 

T I BNUM 
PARM0 
T I BNLJM-+- i 
PARM0+ 1 
EORUP 


5 A C C U M U LATE C H E C K S U M 

5 INCREMENT START A DDR BY 1 
SEND ADDR - START ADDR 


5 NOT DONE ENTIRE RANGE 


PL A 
LDA 
PHA 
JSR 
DB 
PL A 
JSR 
LDA 
JSR 
EOREX 

JMP 


T I BPTR 


PR I NT 


5 INSERT A LINE AND PRINT MESSAGE 


$91) * p CHECKSUM 


0 


PR THE X 

#$9B 

PRTCHR 

NXTCMD 


; PRINT CHECKSUM 

5 PRINT RETURN 
; EXIT TO OMNI MON PROPER 


DUMMY 


RTS 

END 


DUMMY 


DUMMY RTS FOR ATARI MACRO-ASSEMBLER AUTORUN 


This routine contains all the elements of a typical OMNI MON 
extension- First you have the EQUates of all the OMNI MON 
resources you will use in the routine. Then you have the load 
vector to install the routine by storing the address of the 
routine at USRVEC. (The ATARI Macro-Assembler creates a new load 
vector each time an ’ ORG ' is used- If your assembler does not do 
this then you must do it by hand: 

27 01 DW USRVEC 

28 01 DW USRVEC+1 

00 06 DW EORMEM 

If you do not understand about load vectors then read the section 
entitled •" BINARY LOAD FILES 71 .) The routine itself starts by 
reading the 3 user input parameters (JSR TIBCNV) and storing them 
in PARM0 (start addr), TIBNUM (end addr), and the accumulator 
(mask). Then the processing is done with the checksum being 

accumulated in TIBPTR. Finally., the checksum is printed out and 
the user ex tent ion is terminated with ? JMP NXTCMD’ to return to 
OMN I MON p r op er . Stud y t h is r out i n e c ar ef u 1 1 y an d t hen read t he 
detailed descriptions of the entry points which follow. 
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OMNIMON Entry Points: Detailed Descriptions 


User Input 


TIBCNV(*CF36> : 


Converts the next hex 


# in the user input line to 


2 bytes in TIBNUM. 

TIBPTR: Points at or before next # to be? converted in 

J SR TIBCNV -> Affects ACC , X, YSAVE, TIBNUM, TIBPTR 
TIBNUM: Holds 2 byte result of conversion 

N Flag: Set if conversion unsuccessful 


T I B 


GETREC ($CF4B) : Calls CIO to get next user input line to TIB. 
Resets TIBPTR beginning of TIB. Puts line to printer if open. 

J SR GETREC -> Affects ACC, XSAVE, YSAVE, TIBPTR, COMPTR 
TIBPTR: Points to beginning of TIB 


HEXCON ($CF54) : Converts ASCII in accumulator to hex in ACC. 

ACC = ASCII # to convert <#30—39, #41-46) 

JSR HEXCON -> Affects ACC 
ACC “ Hex byte (#00— 0F) 

N Flag: Seet if conversion unsuccessful 


DECONV (#CF27) : Converts decimal # in TIB to 2 bytes in TIBNUM. 
TIBPTR: Points to the beginning of decimal # in TIB 

ACC = First character of decimal # in TIB 
Y REG *= 0 

JSR DECONV -> Affects ACC, X, TIBPTR, TIBNUM, FR0 <#D4-D9) 
TIBNUM: Holds 2 byte result of conversion 

T I BPTR : Po i nt s j ust past dec i ma 1 # in T I B 


ARGU3 (#CF3F) : Converts 3 hex input parameters 

addr end-addr dest i nati on-addr . Used in ’M - ’ 
T I BPTR : Po i. n t s t o first hex # i n T I B 
JSR ARGU3 -> Affects ACC, X, YSAVE, TIBPTR, 


PARM0 : start address 

TIBNUM: destination address 

TIB, T I B+ l : end address - start address (# 

N Flag: Set if conversion unsuccessful 


of the form: start- 

, ? N ? and ? V’. 

TIBNUM, PARM0 , TIB 
bytes > 


SSGET(#CF57) : Converts 2 hex input parameters of the form: start- 

addr end-addr. Assumes defaults if one or both addrs missing. 
TIBPTR: Points to first hex # in TIB 

JSR SSGET -> Affects ACC, X, YSAVE, TIBPTR, TIBNUM, PARM0 
PARM0 : Start address (unchanged if parameter missing) 

TIBNUM: End address (=PARM0 if parameter missing) 

Screen Output 


PRINT <#CF5A) : Prints inline ASCII text following JSR PRINT and 

terminated by 0. 

JSR PRINT - > Affects ACC, XSAVE, YSAVE, TIBPTR 

• • • 

F’RTBLK <#CF51 ) : Print the # of blanks specified in ACC 

ACC : # blanks yoLi wish to print (1—255) 

JSR BLANK -> Affects ACC, TEMP, XSAVE, YSAVE 
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PUTCHR < $CF5D ) : F’r i n t ASC I 1 c: h ar ac t er 
the p r i n t e r :i. f e n a h 1 e d . 


i n A C l; t o s c: r e e n a n d e c: h o t 


( i 


ACC 


A S C: I I c h a r act© r 


JSR PUTCHR 


Af f ec t s X SAVE . YS A VE 


F'RTCHR ($CF60) : Force (unprintable) char to screen, translate 

printable char (-) i f necessary, and echo to printer. 

ACC : ASCII character (e.g., $9B can be printed this wav) 


to 


JSR F’RTCHR 


Affects XSAVE, YSAVE 


CIOCHR ($CF63> : Pass byte in ACC to CIO. 

ACC : byte to pass 

X REG : IOCB# •*- $10 of an OPEN channel 

JSR CIOCHR -> Affects YSAVE 


PRTADR ($CF48) : Print 2 bytes of PARM0 in hex 
PARM0 : 2 byte # to print 

JSR PRTADR ~> Affects ACC « XSAVE, YSAVE 

PR T HEX <$CF39) : Print byte in ACC in hex 
ACC : Byte to be printed 

JSR F'RTHEX -> Affects ACC, XSAVE, YSAVE 


PRTCPU ( $CF3C ) : 

JSR PRTCPU 


Print contents of CPU registers 


Affects ACC 




\ / 


XSAVE, 


\ / rj /\ i » r~ 

T CD H V E , 


PARM0, TEMP 


T IBPTR, TIBNUM, 


PRTLIN ($CF21 ) : Print 8 bytes 0PARM0 in current ouput 
PARM0 : Points to 1st of 8 bytes to be printed 

JSR PRTLIN --> Affects ACC, Y, XSAVE, YSAVE 


f or mat 


Di sk Input/Output 

I NSNUM ( $CF24 ) : Instal I R a m d i s k h a n d 1 e r s i n t o w h a t e v e r d r o a r a m i s 

t ...* 

in memory (replace all references to $E459 and $E453) . 

T I B N U M " D r i v e? # t o a s s i g n t o R a rn d 3. s k 

JSR I NSNUM -> ACC, Y „ X, T IBPTR, XSAVE, YSAVE, PARM0 


DRVTYF* ( $CF2A) : Read drive status to determine density and set the 

b y t e c o u n t i n t h e D C B i n anti c i pat i a n a f r j e x t R E A D o r W R 1 T E 

DRVNUM : Dr i. ve # ( 1 -4 > 

$30 A, 30B: Sector # to be^ next read or written 

JSR DRVTYP ~> Affects ACC. X., Y 

$308,309: Byte count =$80 for single density, $100 for double 


SECTRD ($CF2D) : Read a sector from disk into memory. You 

JSR DRVTYP just prior to using this for the first time 


sh ou 1 d 


$301 : 

$304—305 : 
$308-309: 
$30A— 30B : 
JSR SECTRD 
N F I a g : 


Drive # (set in DRVTYP) 

Buffer address 

Byte count (set in DRVTYP) 

Sector # (set prior to JSR DRVTYP) 
-> Affects ACC, X, Y 
Set if error, ACC and Y= status 
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SECTWR <$CF30> 

J SR DRVTYP 
$30 1 : 


: W r i t e a s e c t or f r o m nr) 0 m o r y 
j u 0 1 p r i o r t o u s i n q this f o r 
Drive # (set. in DRVTYP) 


t: o the d i s k . Y o u 
the -first time. 


$304- 


05 


B u -f f e r addres s 


$308-309: 
$30A— 30B " 


Byte count (set in DRVTYP) 

Sector # (set prior to JSR DRVTYP) 


J SR SECTRD ~> Affects ACC, X, Y 
N Flag : Set if error, ACC and Y= status 


shoul d 


SECINC<$CF33> : Increment DCE< sector # by 1 (or $80 if sector # >= 

$800) and buffer address bv the # of bytes/sect or . 

$308-309: Byte count (set in DRVTYP) 

$304-305: Buffer address (left from last READ or WRITE) 

JSR SEC INC -> ACC 

$30A— 30B: Sector count incremented by 1 

$304—304: Buffer addr incremented by $80 for SD, $100 for DD 


Mi seel 1 aneous 


PCTP AR ( $CF IE): Get user p r og r a m 
b e e x act 1 y J. r e t u r n a d d r e s s 
called- I f you w i sh t o cal I 
j u s t p r i. o r t o t. h e c a I 1 a n d p 
STACK : Must be nested once 


JSR PC TP AR 


/••. 1“' (~- 

• iLL 


Ml 


XSAVE 


counter (PC) to PARM0. 
on t he s t a c k when this 
it, push 2 bytes into 
u 1 1 t; h e m off af terwards. 
from OMNI MON proper 
TIBNUM, PARM0 


There must 
routine is 
the stack 


PARM0 : 
T I BNLJM : 


U s e r p r o g r a m c: o u n t: e r 
P o i n t s 3. n t o s t a c k 1 b v t e b e 1 o w 


user 


CPU r eg 1 s t. er s 


NUMTOP ($CF42) : Transfer 

JSR NUMTOP -> Affects 
PARM0 : Identical to 


2 b y t e c on tents 
ACC, PARM0 
7 I BNLJM 


of 


TIBNUM to PARM0 


I NCPTR < $CF45 ) 

JSR I NCPTR 


I n c r e m e n t 2 fo y t e s 
> TIBPTR 


TIBPTR: 


I n c: r e m €? n t ca d b v 1 

/ 


of TIBPTR bv 


1 - 


INCPAR ($CF4E) : Increment 2 bytes of PARM0 by 1 „ 

JSR INCPAR -> PARM0 
P ARM0 : I n c r emeu t ed by 1 

JMF* Entry Points 


BOOT <$CF&6) : 
NXTCMD ($CF6C) : 
I NPERR ( $CF69 ) : 
AUTGO ( $CF IB) : 

RESTOR ($CF6F) : 
RESET ($CF72) : 
RESET2($CF75> : 
PWRUP0 < $CF78 ) : 


Boot from the drive specified in DRVNUM. 

Normal return from a command 

Same as NXTCMD except ? INPUT ERR’ printed 

Execute from command buffer ©COMF'TR and 

then JMP NXTCMD (Same as ;t 0 addr " command ) 
Exit from OMNIMON. User CPU state restored. 
Normal SYSTEM RESET 
Altered RESET (SELECT/RESET) 

Power up entry for lockup recovery 


Extension Suggestions: 1) Search disk for sequence. 2) Search 
memory with wildcards. 3) A simple line editor for editing disk 
files under OMNIMON control . 
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AXLON Ramdisk Support: 


9 I 9 and commands 


T h e s e c: o m m a n d s a 1 I o w R a m d .i. s k owne r s t o t; a k e f u 3. 3. a d v a n t a q e 
of the power and -flexibility of this marvelous device,. The 

res 3. d e n t. R a m d i s k h a n d 3. e r s i n 0 M N I MO N L a 3. 3. o w y o u t o u s e y o u. r 

Ramdisk with any DOS which uses standard SIO calls <$E459 and 

$ E 4 5 3 ) « Operation o-f the Ramdisk in conjunction with drives other 
than single density is possible i f the DOS will support them 
( e « g „ ? OSA+ , MYDOS , etc . ) - In add i t i on , you will f i nd i t possi b 1 e 
to use the Ramdisk with other boot programs which require a lot 

o-f disk access (e.g., DBMSs, word processors, games, etc.). The 

rule is that any program that will restart when you hit 
RESET (instead o-f rebooting) should be able to use the 
just like any other single density disk drive. It also 


general 
SYSTEM 
Ramd i sk 


makes things easier if the program has no disk copy protection 


The main command to support Ramdisk is "I (drive#) ? . This 
command installs the resident Ramdisk handlers into whatever 
software is currently in memory. It does so by searching all of 
memory for all references to $E459 and $E453 and replacing them 
with hooks into OMNI MOM ($CFC8 and *CFCB respectively). In this 
way all SIO calls are intercepted and examined to see if the 
Ramdisk is being addressed. If it is, the special handlers take 
over. Else, the call is passed on to SIO. 


Installation Technique #1 

The basic technique for installing the Ramdisk handlers is 
to boot-up the software, pop into OMNIMONL with OPTION/RESET, use 
the ' I command and then restart the program by holding down the 
START switch and typing RETURN. This is the same as doing a 
war mst ar t wit h a hr i ef st opover i n OMN I MONL . If h i 1 1 i ng RESET 
causes th program to reboot (e«g„, ATARI DOS 2.0S) then you may 
u se S E L EOT/ R E.\ S E T t o i n t e r r u p t t h e p r ogra m . If t h e p r o g r at m 
restarts when you exit OMNIMONL with START/RETURN, then 
everything is probably fine. If you are unable to restart the? 
program without rebooting then another method can be used (see 
I n s t a 1 1 at t i on Tec h n i qu e # 2 ) „ 

Let's take a t y p i c a 1 ex amp 1 e : 

1) Be sure that your Ramdisk is enabled and boot up ATARI DOS 
2.0S (or any of the many modified versions). Once the DOS menu 
appears, pop into OMNIMONL with SELECT/RESET « 

2) Now type ' I (return) ' . (If you do not specify a drive # after 
the ? I ? , drive #1 will be assumed.) Drive # ■ s equal to or 
greater than the Ramdisk drive # will be incremented bv 1. 

3) Return to the DOS menu by holding down the START switch and 
typing RETURN. Hit RETURN once again to get the menu back. 

4) Format the Ramdisk with the I command of DOS. 

5) Write DOS files to the Ramdisk with the H command of DOS. 

6) Hit SYSTEM RESET. If you did the previous steps correctly, the 
DOS menu should appear very quickly since it will now boot out 
of the Ramdisk. 
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N o w y o u c: a n t r e a t t h e R a rn d is k j u s t. 3. i k e a n y o 1. h e r s i n g 3. e 
d e n s i t. y d r i v e i n t h e sys t e m . I f y o u wis hi t o assig n it a dif fere n t 
drive #, pop into OMNIMGNL and use the 11 I ' command again with the 
new drive #» Notice that once the I ? command has been used , the 
n R ? a n d *" W c: o m rn ands o f 0 M N I M 0 N L w i 3. 1 a 3. s o t r e a t t h e R a m d :i. s k j u s t 
like another disk drive. Use the - L ( # ) ? command to address the 
different d r i v e s i n t h e s v s t. em . 


R a m dis k i n s t a 1 1 a t ion c a n be a c c o rn pi iehed f r o m as s e m b 1 v 
language by storing the drive # in TIBNUM ($94) and doing a J SR: 
INSNUM <$CF24) . The following 11 bytes appended to the end of a 
binary load file will automatically install the Ramdisk handlers 
(where drv# = 1 to 4): 94 00 94 00 drv# E2 02 E3 02 24 CF. 
Appended to the end of DIJF'.SYS, these? load vectors will take the 
place of installation technique #1 when you boot up DOS. 


Installation Technique #2 


This method will allow you to use Ramdisk with 
programs which do not use DOS or have their own file 
system. This method will work only if the program 
u n p r otec: t e c! d i s k . 


many boot 
m ansg e m e n t. 
i s on an 


1 > 


2 ) 

3) 

4) 



Boot up a disk 
drive #1 using 
D u p 1 i c a t e t h e 
dr i ve . 


sec t o r c o p y i n g 
technique #1. 
b o o t d i s k u s i n g 


p r ogr a m . I ns t all the R a m d i s k a s 

the Ramdisk: as the destination 


Pop into OMNIMGNL again and select the Ramdisk with the •“L* 
c omman d . (It is a 1 r eady se 1 ect ed if it is drive # 1 . ) 

Now we must install the Ramdisk handlers into the program on 
the Ramdisk. This is done by reading the program into memory, 
using the “l" command and writing the program back out to 
disk. If the program takes the entire? disk then the following 
s eque n c e will w o r k » R 1 4 0 0 1 0 0 , I , W i 4 0 0 1 0 0 . R 1 0 1 4 0 0 
1 00 , I , W 1 0 1 400 1 00 . R20 1 400 E>0 , I ? W20 1 400 D0 . Th i s i s not as 
much typing as it looks because of the screen editing features 
of OMNI MON. 


Now t.yp:«e " B (return ) ? . This command will boot off the selected 
drive but most of the time will work only on drive #1. It is 
especially useful for booting off the Ramdisk. 


This method may not work with some programs because they 
have interrupt routines located in the address range of $4000 to 
$7FFF. Because Ramdisk uses this area of memory for its bank 
switching, you can see how an interrupt routine in this region 
would not work too well during Ramdisk I/O. 


Once the program is in the Ramdisk, you can always reboot it 
with the? ? B ? command, even if you have run other programs since 
copying it up there. This is especially true if you do the simple 
hardware mod described next. But don't cycle power or the 
contents of Ramdisk will be lost. If you wish to do a coldstart, 
do a ’JE477 (return) ST ART /RETURN ? from OMNIMON or install a 
coldstart switch as indicated on the next page. By the way, the 
Ramdisk uses banks 1 to 7 while the user bank is bank 0. 
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Ramdisk Hardware Modification 


A very useful modification can be made to your Ramdisk board 
to make it much better behaved. It will save you from having to 
•flip the switch on the Ramdisk in order to run software which 
loads into the $FC0—$FFF range. As it stands. writing to this 
address range will cause Ramdisk banks to be switched in in place 
of user memory. This usually causes the program to crash. This 
mod disables the $FC0—$FFF range and doubles the other select 
range from $CFC0-$CFFF to $CF80-$CFFF , which should cause no 
problem. If you do this mod carefully it will probably not affect 
the warranty but it is best to check with AXLON to be safe. In 
the past they have recommended it. 

1) Locate pin 18 on the card edge of the RAM board in the front 
RAM slot (the slot just behind the OS board) . It does not 
matter what type of RAM board this is (16K or 32K) . Follow the 
etch back to a convenient place to solder (perhaps the pin of 
an IC) and solder one end of a 6" wire to this spot. On an 
ATARI 16K board this would be Z501 pin 1. 

2) Locate the 74LS133 IC on the Ramdisk. Solder the other end of 
the wire to pin 1'5 of this IC. Referring to the diagram bel ow , 
make the indicated cut on the underside of the Ramdisk board 
and the mod is complete. 

Coldstart Switch 


This switch connects the RESET button directly to the Reset 
pin on the 6502, allowing you to do a coldstart without cycling 
power. This is especially useful in conjunction with the Ramdisk 
because its contents are preserved as long as you don ? t cycle 
power. (This is not true under the original Memory Management 
System supplied by AXLGN. ) It is also possible to recover from 
system lockup by pushing the coldstart switch and popping into 
□MNIMONL with SELECT /RESET . From that point you can many times 
restart the program by hitting SYSTEM/ RESET (e.g. „ BASIC) . 


Installation is accomplished by disassembling the computer 
and locating the pads on the motherboard as indicated in the 
drawing for the 800. On a 400 the pads are located in the back 
right hand corner between R179 and CR103. A spring loaded switch 
(cheap Radio Shack pushbutton is fine) should be put in series 
with a 47 Ohm 1/4 watt resistor between the two pads. Mount the 
switch just to the left of the cartridge hatch,. , 

i s oiacr here 




to 4 




cut 

here 


Hi: 






*R/8J ON 

ATARI HOO 



* l 

fN 

>4 1 

I 


underside 

of board 
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Command Summary 


A: Alter Memory: A addr byte byte ... - Used to change 1 or more 

contiguous bytes of memory. 

B: Boot Disk: B — Will boot off of the selected drive. Especially 

useful in conjunction with the AXLON Ramdisk. 

C: CPU Registers: C — Used to display and alter the registers. 

D: Display Memory: D (start addr) (end addr) - Used to view 
memory data. To alter memory, position cursor and type change. 

E: Execute Memory: E (option/# steps) — Will execute one or more 
instructions at a time and display intermediate results. 

F: Fill Prgm Buffer: F addr — Teach monitor a sequence of 

commands for later execution with the ? CF command. 

G: Get File: G (file spec) (addr) - A full binary load function, 
single or double density. Doubles as disk directory command. 

H: Hex Conversion: H # — Allows conversion from hex to decimal 

and vice versa on numbers of 1 or 2 bytes. 

H: Hex Arithmetic: H # (# oper) (# oper) ... — Hex conversion 

allowing addition, subtraction, multiplication and division. 

I: Install Ramdisk: I (drv#) - Install Ramdisk handlers into 

whatever program is resident in memory at the time. 

J: Jump Subroutine: J (addr) - Go execute subroutine. 

C: Link Drive: L (drv#) — Select drive # and linked or sequential 
sector modes. All disk I/O will go to the selected drive. 

M: Move Memory: M addr0 addrl addr 2 — Move a block of memory from 
anywhere in memory to anywhere else. 

N: Relocate Memory: N addr0 addrl addr2 (addr3) (addr4) - Adjust 

6502 code that it will execute in another location. 

0: Operate Prgm Buffer: O addr — Execute the commands stored 

earlier with the " F 71 command. 

P: Printer Control: P — Screen I/O can be echoed to a printer. 

R: Read Disk: R (sect#) (buff addr) (# sects) — Read one or more 
sectors from selected disk drive into a specified buffer area. 

S: Search Memory: S addr byte byte ... — Search memory for and 

print out occurrences of a sequence of bytes. 

T: Toggle Format: T - Toggle between hex and character formats. 

U: User command: U — Allows access to user written extensions of 

OMNIMOW. Entry points for commonly used routines provided. 

V: Verify Memory: V addr0 addrl addr2 - Compare 2 blocks of 

memory and print out the differences. 

W: Write Disk: W (sect#) (buff addr) (# sects) - Write one or 

more sectors to disk from a specified buffer address. 

X: Disassembler : X (addr0) (addrl) - Translate machine code into 

assembly language. Can be used to create a source file. 

Y: Assembler: Y addr instr - Translate assembly language into 

machine code one line at a time. Useful for patching programs. 

Z: Exit Monitor: Z - Special exit for use with •‘’O' 1 ’ command. 

Lockup Recovery - Allows recovery from system lockup without 
destroying contents of memory. Requires simple hardware mod. 

I/O Redirection - Allows printer I/O to be redirected to an ' 
device, including a disk file. Saves lots of paper ! 

Happy Support — Allows for easy transfer of memory to and from 
the RAM buffers in the Happy drive. 

Bit-3 Support - Allows user to turn on and off the 80 column mode 
of t he B i t —3 board f rom OMN I MON . 
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